home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Atari Mega Archive 2
/
Atari Mega Archive CD - Volume 2.iso
/
minix
/
up1510b.tgz
/
up1510b
/
doc
/
rz.doc
< prev
next >
Wrap
Text File
|
1990-07-19
|
11KB
|
332 lines
RZ(1) RZ(1)
NAME
rx, rb, rz - XMODEM, YMODEM, ZMODEM (Batch) file receive
SYNOPSIS
rz [- +abepqtuvy]
rb [- +abqtuvy]
rx [- abceqtuv] file
gz file ...
[-][v]rzCOMMAND
DESCRIPTION
This program uses error correcting protocols to receive
files over a dial-in serial port from a variety of programs
running under PC-DOS, CP/M, Unix, and other operating
systems. It is invoked from a shell prompt manually, or
automatically as a result of an "sz file ..." command given
to the calling program.
While rz is smart enough to be called from cu(1), very few
versions of cu(1) are smart enough to allow rz to work
properly. Unix flavors of Professional-YAM are available
for such dial-out application.
Rz (Receive ZMODEM) receives files with the ZMODEM batch
protocol. Pathnames are supplied by the sending program,
and directories are made if necessary (and possible).
Normally, the "rz" command is automatically issued by the
calling ZMODEM program, but some defective ZMODEM
implementations may require starting rz the old fashioned
way.
Rb receives file(s) with YMODEM, accepting either standard
128 byte sectors or 1024 byte sectors (YAM sb -k option).
The user should determine when the 1024 byte block length
actually improves throughput without causing lost data or
even system crashes.
If True YMODEM (Omen Technology trademark) file information
(file length, etc.) is received, the file length controls
the number of bytes written to the output dataset, and the
modify time and file mode (iff non zero) are set
accordingly.
If no True YMODEM file information is received, slashes in
the pathname are changed to underscore, and any trailing
period in the pathname is eliminated. This conversion is
useful for files received from CP/M systems. With YMODEM,
each file name is converted to lower case unless it contains
one or more lower case letters.
Page 1 (printed 4/18/89)
RZ(1) RZ(1)
Rx receives a single file with XMODEM or XMODEM-1k protocol.
The user should determine when the 1024 byte block length
actually improves throughput without causing problems. The
user must supply the file name to both sending and receiving
programs. Up to 1023 garbage characters may be added to the
received file.
Gz is a shell script which calls sz to command Pro-YAM or
ZCOMM to transmit the specified files. Pathnames used with
gz must be escaped if they have special significance to the
Unix shell.
EXAMPLE: gz "-a C:*.c D:*.h"
Rz may be invoked as rzCOMMAND (with an optional leading -
as generated by login(1)). For each received file, rz will
pipe the file to ``COMMAND filename'' where filename is the
name of the transmitted file with the file contents as
standard input.
Each file transfer is acknowledged when COMMAND exits with 0
status. A non zero exit status terminates transfers.
A typical use for this form is rzrmail which calls rmail(1)
to post mail to the user specified by the transmitted file
name. For example, sending the file "caf" from a PC-DOS
system to rzrmail on a Unix system would result in the
contents of the DOS file "caf" being mailed to user "caf".
On some Unix systems, the login directory must contain a
link to COMMAND as login sets SHELL=rsh which disallows
absolute pathnames. If invoked with a leading ``v'', rz
will report progress to /tmp/rzlog. The following entry
works for Unix SYS III/V:
rzrmail::5:1::/bin:/usr/local/rzrmail
If the SHELL environment variable includes rsh or rksh
(restricted shell), rz will not accept absolute pathnames or
references to a parent directory, will not modify an
existing file, and removes any files received in error.
If rz is invoked with stdout and stderr to different
datasets, Verbose is set to 2, causing frame by frame
progress reports to stderr. This may be disabled with the q
option.
The meanings of the available options are:
a Convert files to Unix conventions by stripping carriage
returns and all characters beginning with the first
Control Z (CP/M end of file).
b Binary (tell it like it is) file transfer override.
Page 2 (printed 4/18/89)
RZ(1) RZ(1)
c Request 16 bit CRC. XMODEM file transfers default to 8
bit checksum. YMODEM and ZMODEM normally use 16 bit
CRC.
D Output file data to /dev/null; for testing. (Unix
only)
e Force sender to escape all control characters; normally
XON, XOFF, DLE, CR-@-CR, and Ctrl-X are escaped.
p (ZMODEM) Protect: skip file if destination file exists.
q Quiet suppresses verbosity.
t tim
Change timeout to tim tenths of seconds.
v Verbose causes a list of file names to be appended to
/tmp/rzlog . More v's generate more output.
y Yes, clobber any existing files with the same name.
EXAMPLES
(Pro-YAM command)
<ALT-2>
Pro-YAM Command: sz *.h *.c
(This automatically invokes rz on the connected system.)
SEE ALSO
ZMODEM.DOC, YMODEM.DOC, Professional-YAM, crc(omen),
sz(omen), usq(omen), undos(omen)
Compile time options required for various operating systems
are described in the source file.
NOTES
Sending serial data to timesharing minicomputers at
sustained high speeds has been known to cause lockups,
system halts, kernel panics, and occasional antisocial
behaviour. When experimenting with high speed input to a
system, consider rebooting the system if the file transfers
are not successful, especially if the personality of the
system appears altered.
The Unix "ulimit" parameter must be set high enough to
permit large file transfers.
The TTY input buffering on some systems may not allow long
blocks or streaming input at high speed. You should suspect
this problem when you can't send data to the Unix system at
high speeds using ZMODEM, YMODEM-1k or XMODEM-1k, when
YMODEM with 128 byte blocks works properly. If the system's
tty line handling is really broken, the serial port or the
entire system may not survive the onslaught of long bursts
of high speed data.
The DSZ or Pro-YAM zmodem l numeric parameter may be set to
a value between 64 and 1024 to limit the burst length
("zmodem pl128").
Page 3 (printed 4/18/89)
RZ(1) RZ(1)
32 bit CRC code courtesy Gary S. Brown. Directory creation
code from John Gilmore's PD TAR program.
BUGS
Calling rz from most versions of cu(1) doesn't work because
cu's receive process fights rz for characters from the
modem.
Programs that do not properly implement the specified file
transfer protocol may cause sz to "hang" the port for a
minute or two. Every reported instance of this pro